home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 2000 August: Tool Chest / Dev.CD Aug 00 TC Disk 2.toast / pc / sample code / human interface toolbox / htmlsample / readme < prev    next >
Encoding:
Text File  |  2000-06-23  |  3.5 KB  |  87 lines
  1. HTMLSample
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12. HTMLSample is an application illustrating how to use the new HTMLRenderingLib services found in Mac OS 9. HTMLRenderingLib is Apple's light-weight HTML rendering engine capable of displaying HTML files.
  13.  
  14. HTMLRendering related tasks illustrated include:
  15. • how to draw HTML in a window using the HTMLRenderingLib,
  16. • how to use the URL utilities provided by the HTMLRenderingLib,
  17. • how to maintain a history of visited links and provide call backs to the HTMLRenderingLib for providing information about visited links,
  18. • how to intercept URLs being displayed by the HTMLRenderingLib and re-direct them to other files.  In this example, we use this facility to allow you to launch applications by clicking on URLs that refer to application files.
  19. • Setting up the drawing environment correctly for drawing other objects in the same window when the window contains a HTML rendering object.
  20.  
  21. Other interesting techniques illustrated include:
  22. • This is a Mac OS 9 package savy application.  Techniques for opening HTML package documents are illustrated.  These techniques include opening package documents when they are provided in open document Apple events and allowing the user to choose package documents in the Navigation Services window.
  23. • Graying out a part of the window when it is inactive.
  24. • Setting the standard window zoom state so clicking in its zoom box results in the window being zoomed to the best rectangle for viewing the HTML image being displayed.
  25.  
  26. By John Montbriand.
  27.  
  28. Copyright © 1999 by Apple Computer, Inc.
  29. All rights reserved worldwide.
  30.     
  31. Disclaimer:
  32. You may incorporate this sample code into your applications without restriction, though the sample code has been provided "AS IS" and the responsibility for its operation is 100% yours.  However, what you are not permitted to do is to redistribute the source as "DSC Sample Code" after having made changes. If you're going to re-distribute the source, we require that you make it clear in the source that the code was descended from Apple Sample Code, but that you've made changes.
  33.  
  34. Files:
  35.  
  36. ':HTMLSample Help:' - a directory containing the HTML help files used by the application.
  37.  
  38. ':HTMLSample Pages:' - a directory containing the default HTML pages used by the application.
  39.  
  40. ':HTMLSample.prj Data:' - CodeWarrior project data
  41.  
  42. :obj: - compiled object files
  43.  
  44. AboutBox.c - routines for implementing the HTML about box.
  45.  
  46. AboutBox.h - prototypes for routines defined in AboutBox.c.
  47.  
  48. CIconButtons.c - routines implementing the color icon buttons displayed in the top of the HTML windows.
  49.  
  50. CIconButtons.h - prototypes for routines defined in CIconButtons.c.
  51.  
  52. History.c - routines for maintaining lists of visited links.
  53.  
  54. History.h - prototypes for routines defined in History.c.
  55.  
  56. HTMLSample - the compiled application.
  57.  
  58. HTMLSample.c - the main program and event dispatching code for the program.
  59.  
  60. HTMLSample.h - prototypes for routines defined in HTMLSample.c.
  61.  
  62. HTMLSample.prj - CodeWarrior project file.
  63.  
  64. HTMLSample.r - MPW Rez file for the program.
  65.  
  66. HTMLSample.rsrc - ResEdit resource file containing resources used in the program.
  67.  
  68. MakeFile - MPW make file for building the program.
  69.  
  70. 'Re- C/F Registration Request' - Creator file type registration for the program.
  71.  
  72. ReadMe - see ReadMe.
  73.  
  74. RenderingWindow.c - Routines implementing the windows displayed by the program.
  75.  
  76. RenderingWindow.h - prototypes for routines defined in RenderingWindow.c.
  77.  
  78. SampleUtils.c - utility routines set aside to simplify the example.
  79.  
  80. SampleUtils.h - prototypes for routines defined in SampleUtils.c.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.